home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Commodities / MagicPointer / README-BetaUsers < prev    next >
Text File  |  1996-09-26  |  8KB  |  154 lines
  1.  
  2. Hello MagicPointer BETA tester user!
  3.  
  4. **********************************************************************************************
  5. * This is a BETA version of MagicPointer. I am sending this file to you so that you can      *
  6. * help me with the improvement of MagicPointer. As this is a BETA version, you cannot        *
  7. * give this package to someone else, neither sell it, neither put available to the public.   *
  8. *                                                                                            *
  9. * As MagicPointer will be Shareware, It will have some options disabled. It will require a   *
  10. * keyfile and a keycode so that it can fully function. You cannot give, nor put available    *
  11. * to the public the keyfile neither the keycode.                                             *
  12. *                                                                                            *
  13. * But if you like MagicPointer and don't have money (as I) to send a shareware fee, you can  *
  14. * contact me so that I send a personal, non-crippled version to you.                         *
  15. *                                                                                            *
  16. * Also, if you want to became a registered user and have some program that you have done     *
  17. * that requires registration, you can send me a registred version of your program in         *
  18. * exchange to my registred program. The same applies to the source of the program. You send  *
  19. * a source of a program of yours and I send you the source of MagicPointer                   *
  20. *                                                                                            *
  21. * If you have done some commercial games/programs/utilities and want a registred version of  *
  22. * MagicPointer, send me your commercial game/program/utility and I will send you a registred *
  23. * version of MagicPointer.                                                                   *
  24. *                                                                                            *
  25. * The registration fee if in the MagicPtr10.readme file.                                     *
  26. *                                                                                            *
  27. **********************************************************************************************
  28.  
  29. I need that you carefull test the program looking for bugs and looking for deadlocks.
  30. Until now I have not found a deadlock, but that is possible.
  31.  
  32.  
  33. The status of MagicPointer:
  34.  
  35.  - Preferences editor needs some minor improvements:
  36.    
  37.    o Able to open on a custom screen.
  38.    o Some drawing tools.
  39.    o Talk to the commodity, in a way to tell that user wants to test a pointer, or wants to
  40.      replace the current animation with one of his choice.
  41.    o Set the user information on the preferences file.
  42.    o Allow to draw pointers of any size (max is : [horizontal,vertical] = [64,128])
  43.    o Make the Window a AppWindow so that user can draw preferences files, anim's  and auto
  44.      load them.
  45.    o Load AnimBrush's and Anim files.
  46.    o There is a bug in the Load/Save ILBM routine that trashes the first horizontal line
  47.      of a Frame. Don't use the first line!!! I found many many bugs in MagicPointer to date,
  48.      but that one is really there from the first time. If you have some really cool source
  49.      on how to load/save Anim's/ILBM/AnimBrushes and want to share with me, send it please.
  50.    
  51.  - Commodity:
  52.    
  53.    o This is great: I can make MagicPointer like it is now, but still dont know how to:
  54.    
  55.       o Patch the SetPointer call.
  56.       o Use 16 color pointers. I really need help. Don't know how to do it. Can someone
  57.         email me something on this subject ?
  58.       o Make laced pointers for ECS users. Also some info on this is needed. If you know
  59.         something tell me please!
  60.       
  61.  
  62.  
  63.  I need some icons to my program. If you are skilled or just find that you have drawn a
  64.  cute icon to MagicPointer, send it !!!
  65.  
  66.     Needed Icons:
  67.     
  68.       A Drawer Icon for the distribution package.
  69.       A Tool Icon for the preferences program.
  70.       A Tool Icon for the commodity.
  71.       A Project Icon for the installation program.
  72.       A Default Project Icon for the prefs animations. One for a Normal Pointer,
  73.       one for a Busy Pointer.
  74.       
  75.  
  76.  Also I need loadsa animated normal/busy pointers. Users could upload them to aminet.
  77.  Think its a cool way to promote MagicPointer.
  78.  
  79.  
  80.  
  81.  - ToolTypes:
  82.  
  83.    In the commodity you can specify these tooltypes:
  84.    
  85.    {bool} is either YES/NO or TRUE/FALSE
  86.    {wild} is a string with wildcards. This is used to random select a animation. If you
  87.           want a precise animation, just put the complete name on this tooltype.
  88.  
  89.    {int}    CX_PRIORITY
  90.    {string} CX_POPKEY       : used to pop up the preferences program. NOT IMPLEMENTED YET          
  91.    {bool}   CX_POPUP
  92.    {bool}   QUIET           : do not ask nothing when quiting, etc. NOT IMPLEMENTED YET
  93.    {bool}   SAFE_PATCH        : if your pointer flickers, set this to true.
  94.    {bool}   PATCH_SETPOINTER: patch set pointer ? NOT IMPLEMENTED YET
  95.    {bool}   ANIM_RESTART    : restart anim each time a pointer is asked ? this in reality
  96.                               makes each window have a unique frame start. So animations
  97.                               in diferent windows are independent. NOT IMPLEMENTED YET
  98.    {wild}   NORMAL_ANIM     : The Normal Animation. Complete Path Name. Can have wildcards.
  99.    {wild}   BUSY_ANIM       : The Busy Animation. Complete Path Name. Can have wildcards.
  100.    {int}    WINCLIENTS        : this controls an internal list of the number of windows open.
  101.                                 256 is enough !!!
  102.    {int}    RESX              : horizonal resolution. Passed to NewObject() when creating a pointer.
  103.                                 see include:intuition/pointerclass.h
  104.                
  105.                0 :   DEFAULT (ECS-compatible pointer width)
  106.                1 :     140NS (pointer always in 140ns pixels)
  107.                2 :      70NS (pointer always in  70ns pixels)
  108.                3 :      35NS (pointer always in  35ns pixels)
  109.                4 : SCREENRES (same as pixel speed of screen
  110.                5 :     LORES (pointer always in lores-like pixels) = 140ns in 15kHz modes, 70ns in 31kHz modes
  111.                6 :     HIRES (pointer always in hires-like pixels) =  70ns in 15kHz modes, 35ns in 31kHz modes
  112.                
  113.    
  114.                                 
  115.    {int}    RESY              : vertical resolution. Same as previous.
  116.    
  117.                0 :         DEFAULT
  118.                     ( in 15kHz modes, the pointer resolution will be the same as a non-interlaced screen,
  119.                       in 31kHz modes, the pointer will be doubled vertically
  120.                     )
  121.                2 :            HIGH
  122.                3 :      HIGHASPECT
  123.                     (  Where the hardware/software supports it, the pointer resolution
  124.                     will be high.  This means there will be about 400-480 pointer
  125.                     lines per screen.  HIGHASPECT also means that
  126.                     when the pointer comes out double-height due to hardware/software
  127.                     restrictions, its width would be doubled as well, if possible
  128.                     (to preserve aspect).                                            
  129.                     )
  130.  
  131.                4 :       SCREENRES
  132.                5 : SCREENRESASPECT
  133.                     (  Will attempt to match the vertical resolution of the pointer
  134.                     to the screen's vertical resolution.    POINTERYRESN_SCREENASPECT also
  135.                     means that when the pointer comes out double-height due to
  136.                     hardware/software restrictions, its width would be doubled as well,
  137.                     if possible (to preserve aspect)
  138.                  )
  139.                
  140.    
  141.    
  142.    {int}    FRAME_DELAY       : 1 -> fast ... 50000 -> slow
  143.    {int}    RUNPRI            : Priority of the task. 10 is a good value
  144.    {int}    STARTPRI          : this should be -127 so that PatchPointer is run before MagicPointer.
  145.  
  146.  
  147.    
  148.  
  149.  
  150.  Please feel free to contact me on:
  151.      L38058@ALFA.IST.UTL.PT
  152.  
  153.  
  154.